home *** CD-ROM | disk | FTP | other *** search
/ The Original Shareware 1.1 / The Original Shareware (WeMake CDs)(Volume 1.1)(CDs, Inc)(1993).iso / 7 / wabird.zip / WABIRD.DOC < prev   
Text File  |  1989-04-27  |  17KB  |  428 lines
  1.  
  2.  
  3.  
  4.                         \\     //
  5.                       ____\   /____                        
  6.                      //~~\\   //~~\\                         
  7.                     ((  _ )}={(  _ ))                        
  8.                      \\(*//   \\(*//  Watch                  
  9.                       ~~~~     ~~~~                     _|   
  10.                                                      -=(~))   
  11.                                                         ||_____|+ 
  12.                                                        (       ) 
  13.                                                         (_____)
  14.                                                           | |
  15.                                                           | +--\
  16.                                                    Bird   /
  17.  
  18.  
  19.                                * WatchBird v1.00 *
  20.                         The ultimate carrier-wise utility
  21.  
  22.                        (C) CopyRight 1989 by Angelo Besani
  23.                     Co-SysOp on <AmnesiA CBCS> Varese - Italy
  24.              (FidoNet 2:331/101.0) 2400,V21,MNP,CM,XA #39-331-263425
  25.         Documentation by Alberto Morosi, SysOp of....well, the same board!
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.         A  lot  of  SysOps  have always been  complaining  about  the  way 
  68.         carrier  watchers behaved:  rebooting their system without leaving 
  69.         any  chance to save or to preserve what they or their  users  were 
  70.         doing if they were running a multitasking environment.
  71.         As  always  happens,  we never realized how much annoying  it  was 
  72.         until we had to use this system on our board ;-).
  73.         Somebody  gave us WatchKat,  and we used it.  The idea was  really 
  74.         great,  but WaKat did *NOT* exit from COMMAND.COM,  it was a nasty 
  75.         limitation,  so we wanted something more and ...after WatchDog and 
  76.         WatchKat, why not to have also WATCHBIRD???
  77.  
  78.         WatchBird  really  does what any SysOp ever wanted from a  watchcd 
  79.         utility:  it runs outside programs, controls the carrier and if it 
  80.         drops gets back to DOS without rebooting, uses a fossil driver but 
  81.         also  does  something more.  WatchBird will close all  your  files 
  82.         while exiting, avoiding the creation of lost chains; will remember 
  83.         the  status  of your screen and put it back from graphic  to  text 
  84.         mode or vice-versa;  will remember in which directory you were and 
  85.         put you back there; will avoid your machine hanging for an "Abort, 
  86.         Retry,  Ignore?"  request;  will allow you to run programs  either 
  87.         through command.com either spawning them directly.
  88.         WatchBird is the ultimate "carrier-wise" utility!
  89.  
  90.         Now,  after  the  commercial spot (uh!) let's  really  talk  about 
  91.         WatchBird.
  92.         By typing WABIRD HELP on your keyboard you will see:
  93.  
  94.                                    WatchBird v 1.00
  95.         (C) 1989 By Angelo Besani, AmnesiA CBCS 2:331/101 +39-331-263425 *ITALY*
  96.                         Slogan: Do BirdWatching, not hunting!!
  97.  
  98.         Usage: WABIRD [switches..]
  99.         where [Switches..] are:
  100.  
  101.         /COMx  Select com port (x in range 1 thru 9)
  102.         /IOAx  Select serial port I/O address (x is an hex number)
  103.         /WBEx  Wait x seconds before exiting after carrier loss (x in range 0 thru 9)
  104.         /NSR   No Screen Re-Adjusting before exiting WatchBird
  105.         /NDR   No Disk&Directory restoring before exiting WatchBird
  106.         /NFC   No File Closing before exiting WatchBird
  107.         /LDT   Lower DTR after carrier loss
  108.         /PBS   Purge Input&Output Buffers before exiting WatchBird
  109.                (This switch requires a compatible fossil driver)
  110.         /NCE   Intercept DOS critical errors and exit
  111.         /DKS   Disable Keyboard Security (not recommended)
  112.         /DEVx  Redirect StdIn, StdOut, StdErr to device 'x'
  113.         /PRGx  Executes program 'x' instead of COMMAND.COM
  114.         /PRM   Passes rest of line to the program as command line switches
  115.  
  116.         This are all the "amazing" features of this little bird-watcher.
  117.         Now  we  will pass through all them giving a brief  but,  I  hope, 
  118.         quite useful description of their functions.
  119.  
  120.  
  121.  
  122.         WatchBird v1.00                                          Page 1
  123.  
  124.  
  125.  
  126.         WABIRD  can  be invoked by any of the commonly  used  outside  bbs 
  127.         doors  (i.e.  in  Opus-CBCS you may use as a ^OC as any of the  O) 
  128.         options, including the ones of msg and file section).
  129.  
  130.         Examples:
  131.  
  132.         ^OCWABIRD /switches
  133.  
  134.         %
  135.         Outside Dos C:\Opus\Wabird.com /switches
  136.         %
  137.  
  138.         %
  139.         Outside Run C:\Opus\Wabird.com
  140.         %
  141.  
  142.         %
  143.         External Message_Management C:\Opus\Wabird.Com
  144.         %
  145.  
  146.         All  these ways would run,  but remember that the "spawn" function 
  147.         doesn't allow passing command line parameters,  so you wouldn't be 
  148.         able  to  let WatchBird do what you want beacuse it will use  only 
  149.         default settings. To avoid this problem you can use such utilities 
  150.         as  CHILD2  or CHILD,  also (c) Angelo Besani  and  available  for 
  151.         filereq on 2:331/101 using magic filename CHILD2 (less than 10Kb).
  152.  
  153.         Let's now analyze each command line switch:
  154.  
  155.  
  156.         /COMx           Select Serial Port (x in range 1 to 9)
  157.  
  158.         Tells to the FOSSIL driver which comm port to reset on exit.  This 
  159.         switch is necessary only if also /PBS (see below) is used.
  160.         Default value= /COM1
  161.  
  162.         /IOAx           Select serial port I/O address (x is an hex number)
  163.  
  164.         This switch is necessary: it specifies the hexadecimal I/O address 
  165.         of the port that WaBird will "watch".
  166.         Default values: /IOA3F8 if /COM1 is specified
  167.                         /IOA2F8 if /COM2 is specified
  168.                         There is no default for different values of /COMx
  169.         So, if you are using COM1 or COM2 you may not specify this switch.
  170.  
  171.         /WBEx           Wait x seconds before exiting on carrier loss
  172.  
  173.         WatchBird has been fully tested under DESQview v2.01 and v2.23.
  174.         Under  v2.23 we have noticed that if carrier dropped while DV  was 
  175.         beep-ing  it sometimes caused the machine to hang.  Setting up  an 
  176.         higher  wait time (x has a range from 0 to 9) you may let DV  stop 
  177.         sending out beeps and allow WatchBird to exit without problems.
  178.         If  you use values different than 0 for this switch,  please  take 
  179.         care  that your modem makes no echo to the characters it  receives 
  180.         (AT  E0  in Hayes mode) because otherwise it may cause  a  strange 
  181.  
  182.  
  183.         WatchBird v1.00                                          Page 2
  184.  
  185.  
  186.  
  187.         loop: if, for example, the modem would respond NO CARRIER, the DOS 
  188.         would  echo it back to the modem,  that would echo it back to  DOS 
  189.         that would echo it back to the modem and so on....
  190.         The  value  of  this switch represents the  minimum  delay  before 
  191.         exiting  and  may  generate a bit higher time  under  multitasking 
  192.         systems or if there was something being performed by DOS.
  193.         Default value: /WBE2
  194.  
  195.         /NSR            No screen re-adjusting before exiting WatchBird
  196.  
  197.         WatchBird  when  started will memorize the current display  status 
  198.         (40/80 colums, text or graphics etc.) and will by default get back 
  199.         to  that  status when exiting after carrier is dropped or after  a  
  200.         normal  termination.  If you will specify this  switch,  WatchBird 
  201.         will exit WITHOUT returning to the original display status.
  202.  
  203.         /NDR            No Disk&Directory restoring before exiting WaBird
  204.  
  205.         WatchBird  will  by default put you back at the disk and path  you 
  206.         were when invoking it. In fact, this function works on the current 
  207.         drive only.
  208.         Example (* indicates the current drive):
  209.  
  210.         * C:\
  211.           D:\
  212.  
  213.         I invoke WABIRD and then change dir (cd UTILS). I will have:
  214.  
  215.         * C:\UTILS
  216.           D:\
  217.  
  218.         Then I change disk (D:)...
  219.  
  220.           C:\UTILS
  221.         * D:\
  222.  
  223.  
  224.           C:\UTILS
  225.         * D:\TEMP
  226.  
  227.         the  carrier drops (or I simply type EXIT) and WaBird  exits... 
  228.         I will find...
  229.  
  230.         Without /NDR          With /NDR
  231.         * C:\                 C:\UTILS
  232.           D:\TEMP           * D:\TEMP
  233.  
  234.         /NFC            No file closing before exiting WatchBird
  235.  
  236.         WatchBird will by default close all the open files before  exiting 
  237.         using  the CLOSE_HANDLE DOS function with HANDLE from 5 to 13  (or 
  238.         15?? Gosh, I don't remember...).
  239.         WatchBird  will  not  close  the files that  were  open  with  the 
  240.         FILE  CONTROL  BLOCKS method.  However,  this is now  an  obsolete 
  241.         programming  style,  because  it may be used only to be  backwards 
  242.  
  243.  
  244.         WatchBird v1.00                                          Page 3
  245.  
  246.  
  247.  
  248.         compatible with DOS v1.xx
  249.  
  250.         /LDT            Lower DTR before exiting WatchBird
  251.  
  252.         If you specify this switch, WatchBird will lower the Data Terminal 
  253.         Ready signal of the "watched" port immediately after carrier loss.
  254.         This option is very useful to avoid having the modem  interpreting 
  255.         as commands the random characters received from the computer.
  256.  
  257.         /PBS           Purge I/O buffers before exiting WatchBird
  258.  
  259.         This switch requires the use of a FOSSIL compatible driver.
  260.         WatchBird  will purge twice FOSSIL's I/O buffers:  the first  time 
  261.         immediately  after  carrier loss and the second time  just  before 
  262.         exiting.  If  you  have installed a TSR that is hooked on INT  14, 
  263.         WatchBird may terminate with a "*** WARNING *** Can't find  FOSSIL 
  264.         driver" message, but it however performs the purge calls.
  265.  
  266.         /NCE           Intercept DOS critical errors and exit.
  267.  
  268.         If you specify this switch,  WatchBird will intercept INT 24h, the 
  269.         DOS critical error.  If the program that is being run generates an 
  270.         "Abort,  Retry,  Ignore?" WaBird will put "Abort" and exit without 
  271.         waiting for a human input.
  272.         Warning:  this  line switch won't work if the program handles  INT 
  273.         24h by itself (i.e. COMMAND.COM).
  274.  
  275.         /DKS           Disable Keyboard Security
  276.  
  277.         If  the carrier drops and the program actually being run hangs the 
  278.         keyboard  (not  the computer!) try using this  switch:  there  are 
  279.         a fiew chances that it will run fine.
  280.         This option is however not recommended.
  281.  
  282.         /DEVx          Redirect StdIn,StdOut & StdErr to device x
  283.  
  284.         Redirects the Standard Input, the Standard Output and the Standard 
  285.         Error to the specified device (COM1 or i.e. GATE1 or other).
  286.         This function can be used instead of DOS' CTTY or where (as  under 
  287.         DESQview)  CTTY does not work.  In some cases it _MAY_ cause  some 
  288.         problems with the use of CTS/RTS: try it, it _MAY_ also work fine!
  289.         If  you  must redirect the StdIn or StdOut only you can  use  DOS' 
  290.         redirections < and >.
  291.  
  292.         /PRGx          Executes program x instead of COMMAND.COM
  293.  
  294.         Executes  program  x.  If not specified WatchBird will default  to 
  295.         %COMSPEC% .
  296.         Example: WABIRD /PRGd:\opus\espsysop.com
  297.         You  MUST  specify  the  file extension (.COM  or  .EXE)  and  the 
  298.         complete pathname, unless the file is in the current directory.
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.         WatchBird v1.00                                          Page 4
  306.  
  307.  
  308.  
  309.         /PRMx           Passes the rest of the line as command line switches
  310.  
  311.         Everything  written after this switch will be passed  directly  to 
  312.         the  program  being executed.  For example,  if you want to run  a 
  313.         batch file from WatchBird, you can use this syntax:
  314.  
  315.         WABIRD /PRM/CBATCH.BAT
  316.  
  317.         Watchbird  will invoke the program (in this case  COMMAND.COM  for 
  318.         default)  and pass it /CBATCH.BAT,  so that the command line being 
  319.         executed will be:
  320.  
  321.         COMMAND.COM /CBATCH.BAT
  322.  
  323.  
  324.         ErrorLevels:
  325.  
  326.         If  /PRGx  switch has been specified,  WatchBird will  return  the 
  327.         errorlevel of the program plus its own.
  328.         WatchBird's own errorlevels:
  329.         255   -    General kind of error (I.E.  the program  specified  by 
  330.                    /PRGx was not found)
  331.         254   -    Carrier Detect was already low when WaBird was run
  332.         253   -    Carrier Lost
  333.         252   -    If   /NCE   switch   was  specified   and   an   Abort, 
  334.                    Retry, Ignore? was occurred
  335.         0      -   If  /PRG  was not specified and  WatchBird  terminated 
  336.                    normally with an EXIT command from the on-line user  or 
  337.                    from the batch file
  338.  
  339.  
  340.                WatchBird  v1.00 + The ultimate carrier-wise utility  
  341.                (c) 1989 by Angelo Besani (2:331/101.1) Co-SysOp on 
  342.                  <AmnesiA CBCS> (FidoNet 2:331/101) Varese/Italy
  343.                         #39-331-263425 2400,CM,V21,MNP,XA
  344.  
  345.         This program is released to the Public Domain of FidoNet's SysOps.
  346.         No  commercial  purpose of this utility is permitted  without  the 
  347.         written license of the author.
  348.         MASM   source   codes  are  available  only  under  the   author's 
  349.         permission.
  350.         In keeping with the spirit of the World Opus Consortium,  you must 
  351.         use and share this utility with your friends providing  everything 
  352.         is done in a lawful and friendly manner.
  353.         Each  and  every suggestion and/or bug report will  be  cheerfully 
  354.         welcome on 2:331/101.
  355.         We will also give technical support if we'll have enough time, but 
  356.         please do not abuse of it!
  357.         The  latest version of WatchBird is always available on  2:331/101 
  358.         filerequesting the magic filename WABIRD.
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.         WatchBird v1.00                                          Page 5
  367.  
  368.  
  369.  
  370.         Other products from <AmnesiA CBCS>, made and (c) by Angelo Besani:
  371.  
  372.         POINTER -
  373.         The  tools  that  enables  Opus-CBCS 1.03b  to  keep  ALL  message 
  374.         pointers  in  ALL  message areas for  ALL  users.  Includes  fully 
  375.         documented manual in Italian and English language.
  376.         Pointer  is  lightning fast and used by lots of BBS in  Italy  and 
  377.         abroad.  The  latest  version  of Pointer is always  available  on 
  378.         2:331/101 with the magic filename POINTER
  379.  
  380.         CHILD2 -
  381.         How to run huge programs from the file or message section O)utside 
  382.         command  of Opus-CBCS v1.03b even if you are in a 200Kb  partition 
  383.         of a multitasking environment? Child2 will swap all Opus' resident 
  384.         portion  to disk or directly to expanded memory leaving RAM  space 
  385.         for your use.
  386.         We use it successfully to run OpusXpress,  TradeWars II, FView and 
  387.         to have a large remote SysOp's DOS shell.
  388.         The  latest  version is always f'reqable on 2:331/101 using  magic 
  389.         filename CHILD2
  390.  
  391.         QLCOMM.EXW
  392.         If  somebody  still  has  a QL....well,  this  is  the  very  best 
  393.         communication program for that computer.
  394.         ProComm-like,  Qlcomm  was  written using Assembler 68000 to  give 
  395.         Sinclair QL users a good tool to logon to Opus systems.
  396.         Includes ANSI emulation, Xmodem protocol, dialing directory, full-
  397.         support for Hayes-compatible modems.
  398.         F'reqable as QLCOMM.EXW on 2:331/101
  399.  
  400.  
  401.         Coming soon:
  402.  
  403.         AV_ANSI.SYS 
  404.         An  enhanced  ANSI  + AVATAR  emulation  device  driver  including 
  405.         standard or enhanced keyboard redefinition,  EGA and VGA supertext 
  406.         mode (any number of lines) and more...
  407.         Now Beta-Testing on <AmnesiA CBCS> (FidoNet 2:331/101.0)
  408.  
  409.  
  410.         A shake of hands to all the fellow SysOps and.....enjoy it!
  411.         Angelo & Alberto.
  412.  
  413.  
  414.  
  415.  
  416.  
  417.  
  418.  
  419.  
  420.  
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.         WatchBird v1.00                                          Page 6
  428.